LINE Pay決済 インタフェース
概要
リンクタイプ Plus決済では、決済手段としてLINE Pay決済を利用することが可能です。LINE Pay決済を利用するには、実行パラメータセットにLINE Pay決済に必要なパラメータを渡す必要があります。
リンクタイプ Plus決済でLINE Pay決済が完了すると、遷移先URLにLINE Pay決済の結果パラメータが返却されます。
遷移先URLは設定により異なるパラメータを参照します。
詳細は「決済画面からの加盟店様サイトへの遷移」をご覧ください。
入出力パラメータ仕様
実行パラメータ仕様
LINE Pay決済固有の実行パラメータは以下の通りです。
| json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | ||
|---|---|---|---|---|---|
| リンクタイプPlus決済URL | 加盟店デフォルト設定 | ||||
| linepay |
LINE Pay決済固有実行パラメータLINE Pay決済の実行パラメータセットです。 |
〇 | 〇 | ||
| JobCd | 必須
処理区分以下のいずれかを設定します。AUTH:仮売上 CAPTURE:即時売上 |
〇 | 〇 | AUTH | |
| ProductName | 必須全半角4000バイト
商品名お客様のLINE Payアプリに表示される商品名を指定可能です。入力文字の制限はございません。 ※半角記号(^ ` { | } ~ & < > " ' のみ)が入力された場合、全角記号(＾ ' ｛ ｜ ｝ ～ ＆ ＜ ＞ " ')に変換されます。 ※文字バイトチェックは UTF-8 を使用しているため、全角文字は 3byte で換算されます。 |
〇 | 〇 | (null) | |
| ProductImageUrl | 半角英数記号500桁
商品画像URL決済画面に表示する画像のURLを指定可能です。サイズは「40 X 40」です。 |
〇 | 〇 | (null) | |
| Mid |
LINE member ID予約項目のため、省略してください。指定しても利用されません。 |
- | - | - | |
| LangCd | 半角英数10桁
言語コードLINE Pay画面の言語コードを指定可能です。※リンクタイプ Plusの言語設定とは異なります。 ja:日本語 ko:韓国語 en:英語 zh-Hans:中国語 (簡体字) zh-Hant:中国語 (繁体字) th:タイ語 対応していない言語コードが指定された場合は、英語(en)が設定されます。 |
〇 | 〇 | ja | |
| BranchName | 全半角500バイト
店舗名決済を要求した店舗名を設定します。100文字まで表示可能です。 |
〇 | 〇 | (null) | |
| BranchID | 半角英数記号32桁
店舗ID決済がリクエストされた場所を識別するために利用します。半角英数字、半角記号(除く ^ ` { | } ~ & < > " ' )が使用可能です。 |
〇 | 〇 | (null) | |
※設定可能な文字については「プロトコルタイプ(マルチ決済インタフェース仕様) 表 1.1-1 入出力項目の定義」を参照してください。
結果パラメータ仕様
LINE Pay決済を選択した場合に、加盟店様に返却するLINE Pay決済固有の結果パラメータは以下の通りです。
| linepay | 半角英数32桁 固定
LINE Pay決済固有部LINE Pay決済固有の結果パラメータセットです。 |
|
|---|---|---|
| Status |
取引状態取引の状態を示す以下の値が設定されます。AUTH:仮売上 CAPTURE:即時売上 PAYFAIL:決済失敗（決済がエラーとなり支払いに失敗してしまった状態） PAYCANCEL:決済中止（お客様の操作により、決済が中止された状態） |
|
| TranID | 半角数字19桁
取引番号LINE Payの取引番号が設定されます。 |
|
| ProductName | 全半角4000桁
商品名商品名が設定されます。 |
|
| PayMethod | 半角英数20桁
支払手段決済時に使用した決済手段が設定されます（クレジットカード：CREDIT_CARD, 残高：BALANCE）。 |
|
| CancelAmount | 半角数字8桁
キャンセル金額キャンセル時の金額が設定されます。 |
|
| CancelTax | 半角数字7桁
キャンセル税送料キャンセル時の税送料が設定されます。 |
|
| TranDate | 半角数字14桁
決済日時決済を行った日時が設定されます。（yyyyMMddHHmmss形式） |
|